Skip to content

docs: Additional troubleshooting steps#460

Merged
Roopan-Microsoft merged 23 commits into
devfrom
psl-troubleshootdoc
Sep 19, 2025
Merged

docs: Additional troubleshooting steps#460
Roopan-Microsoft merged 23 commits into
devfrom
psl-troubleshootdoc

Conversation

@NirajC-Microsoft

Copy link
Copy Markdown
Contributor

Purpose

This pull request significantly expands and improves the troubleshooting documentation for Azure deployment errors in docs/TroubleShootingSteps.md. It adds detailed guidance for many new error scenarios, clarifies existing sections, and provides links to relevant Microsoft documentation for easier self-service resolution.

Expanded error coverage and improved guidance:

  • Added troubleshooting steps for several new errors, including Unauthorized - Operation cannot be completed without additional quota, ParentResourceNotfound, ResourceProviderError, Conflict - Cannot use the SKU Basic with File Change Audit, AccountPropertyCannotBeUpdated, InvalidRequestContent, ReadOnlyDisabledSubscription, SkuNotAvailable, CrossTenantDeploymentNotPermitted, RequestDisallowedByPolicy, FlagMustBeSetForRestore/NameUnavailable/CustomDomainInUse, PrincipalNotFound, RedundancyConfigurationNotAvailableInRegion, and DeploymentNotFound. Each new section includes practical steps and links to official documentation.

  • Expanded existing error summary groups to cover additional related error codes, such as combining DeploymentModelNotSupported, ServiceModelDeprecated, and InvalidResourceProperties, and adding The language expression property array index is out of bounds to the group with resource ID errors.

Clarifications for resource ID errors:

  • Added a specific note and example for the error The language expression property array index '8' is out of bounds, clarifying that it is caused by incomplete resource IDs and providing guidance on correct formatting.

Links and references for further troubleshooting:

  • Each error section now includes direct links to relevant Microsoft documentation for deeper troubleshooting, making it easier for users to find solutions and official guidance.

These changes make the troubleshooting guide much more comprehensive and user-friendly, helping users resolve a broader range of deployment issues more efficiently.

  • ...

Does this introduce a breaking change?

  • Yes
  • No

How to Test

  • Get the code
git clone [repo-address]
cd [repo-name]
git checkout [branch-name]
npm install
  • Test the code

What to Check

Verify that the following are valid

  • ...

Other Information

This comment was marked as resolved.

This comment was marked as resolved.

NirajC-Microsoft and others added 4 commits September 8, 2025 17:16
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Removed duplicate lines explaining the DeploymentNotFound issue and its avoidance.

@Suicynic Suicynic left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

multi-agent

@Roopan-Microsoft Roopan-Microsoft merged commit 287ef57 into dev Sep 19, 2025
9 checks passed
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 2.2.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

deepammi pushed a commit to deepammi/Multi-Agent-Custom-Automation-Engine-Solution-Accelerator that referenced this pull request Dec 7, 2025
@Priyanka-Microsoft Priyanka-Microsoft deleted the psl-troubleshootdoc branch December 25, 2025 09:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants